Delete JWT readers by email addresses. Removes the readers and marks their analytics data as anonymous.
- 12 May 2026
- 4 Minutes to read
- Contributors
- Print
- DarkLight
Delete JWT readers by email addresses. Removes the readers and marks their analytics data as anonymous.
- Updated on 12 May 2026
- 4 Minutes to read
- Contributors
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback!
Delete
/v3/projects/{project_id}/readers/jwt
Deletes JWT-authenticated readers identified by their email addresses and anonymizes their associated analytics data so it can no longer be traced back to individual users. Email addresses are passed as a repeated query parameter (e.g., [email protected]&[email protected]). If the email list is empty or null, no action is taken and a 204 is still returned. Requires the UpdateRolesAccountsAndGroups permission. Related endpoint: DELETE /v3/projects/{projectId}/readers/{readerId} to delete a single reader by ID.
Security
OAuth
All V3 endpoints require a Bearer token. Generate tokens in the Document360 portal under Settings > API Tokens. Tokens are project-scoped, require the customerApi scope, and do not expire by default. Tokens can be revoked at any time from the portal. Include the token in every request: Authorization: Bearer <your-token>. Alternatively, use the Authorize button below to sign in via OAuth2 Authorization Code flow with PKCE.
FlowAuthorization Code
Authorization URLhttps://identity.document360.net/connect/authorize
Token URLhttps://identity.document360.net/connect/token
Scopes:
customerApiDocument360 Customer API
Path parameters
project_id
string (uuid) Required
The unique identifier of the project. Retrieve project IDs from GET /v3/projects.
Example9a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d
Query parameters
email_ids
array of string
List of email addresses of the JWT readers to delete.
Responses
204
JWT readers deleted successfully.
401
Authentication token is missing or invalid.
Headers
WWW-Authenticate
string
Indicates the authentication scheme required. Returns `Bearer` with optional `error` and `error_description` parameters per RFC 6750.
Missing or invalid token
Authentication token is missing or invalid.
{
"type": "https://developer.document360.com/errors/unauthorized",
"title": "Unauthorized.",
"status": 401,
"detail": "The authentication token is missing or has expired.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "UNAUTHORIZED",
"message": "Bearer token is missing or invalid.",
"field": null,
"details": null
}
],
"warnings": null
}object
RFC 7807 Problem Details response for V3 API errors. Content-Type: application/problem+json
type
string
URI reference identifying the error type (links to documentation).
Min length1
title
string
Short human-readable summary of the error type.
Min length1
status
integer (int32)
HTTP status code.
detail
string | null
Human-readable explanation specific to this occurrence.
instance
string | null
URI of the request that generated the error.
trace_id
string | null
Request trace identifier for correlation.
errors
Array of object (ApiError) | null
Structured list of specific errors (extension field).
object
Represents an error returned by the API.
code
string
Machine-readable error code (e.g. VALIDATION_ERROR, RESOURCE_NOT_FOUND).
Min length1
message
string
Human-readable error message.
Min length1
field
string | null
The request field that caused the error, if applicable.
details
string | null
Additional context about the error.
warnings
Array of object (ApiWarning) | null
Non-fatal warnings (extension field).
object
Represents a non-fatal warning from the API.
code
string
Machine-readable warning code.
Min length1
message
string
Human-readable warning message.
Min length1
429
Rate limit exceeded. Retry after the duration specified in the Retry-After header.
Headers
Retry-After
integer
Number of seconds to wait before retrying the request. Use exponential backoff with jitter for optimal retry behavior.
X-RateLimit-Limit
integer
The maximum number of requests allowed in the current time window. Limits are applied per API token per project.
X-RateLimit-Remaining
integer
The number of requests remaining in the current time window. When this reaches 0, subsequent requests will receive a 429 response.
X-RateLimit-Reset
integer
The UTC epoch timestamp (in seconds) when the current rate limit window resets.
Rate limit exceeded
Rate limit exceeded.
{
"type": "https://developer.document360.com/errors/too-many-requests",
"title": "Too Many Requests.",
"status": 429,
"detail": "Rate limit exceeded. Retry after the duration specified in the Retry-After header.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "TOO_MANY_REQUESTS",
"message": "Rate limit exceeded. Retry after the duration specified in the Retry-After header.",
"field": null,
"details": null
}
],
"warnings": null
}object
RFC 7807 Problem Details response for V3 API errors. Content-Type: application/problem+json
type
string
URI reference identifying the error type (links to documentation).
Min length1
title
string
Short human-readable summary of the error type.
Min length1
status
integer (int32)
HTTP status code.
detail
string | null
Human-readable explanation specific to this occurrence.
instance
string | null
URI of the request that generated the error.
trace_id
string | null
Request trace identifier for correlation.
errors
Array of object (ApiError) | null
Structured list of specific errors (extension field).
object
Represents an error returned by the API.
code
string
Machine-readable error code (e.g. VALIDATION_ERROR, RESOURCE_NOT_FOUND).
Min length1
message
string
Human-readable error message.
Min length1
field
string | null
The request field that caused the error, if applicable.
details
string | null
Additional context about the error.
warnings
Array of object (ApiWarning) | null
Non-fatal warnings (extension field).
object
Represents a non-fatal warning from the API.
code
string
Machine-readable warning code.
Min length1
message
string
Human-readable warning message.
Min length1
500
An unexpected server error occurred.
Unexpected server error
Unexpected server error.
{
"type": "https://developer.document360.com/errors/internal-error",
"title": "Internal Server Error.",
"status": 500,
"detail": "An unexpected error occurred. Please try again or contact support.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected error occurred.",
"field": null,
"details": null
}
],
"warnings": null
}object
RFC 7807 Problem Details response for V3 API errors. Content-Type: application/problem+json
type
string
URI reference identifying the error type (links to documentation).
Min length1
title
string
Short human-readable summary of the error type.
Min length1
status
integer (int32)
HTTP status code.
detail
string | null
Human-readable explanation specific to this occurrence.
instance
string | null
URI of the request that generated the error.
trace_id
string | null
Request trace identifier for correlation.
errors
Array of object (ApiError) | null
Structured list of specific errors (extension field).
object
Represents an error returned by the API.
code
string
Machine-readable error code (e.g. VALIDATION_ERROR, RESOURCE_NOT_FOUND).
Min length1
message
string
Human-readable error message.
Min length1
field
string | null
The request field that caused the error, if applicable.
details
string | null
Additional context about the error.
warnings
Array of object (ApiWarning) | null
Non-fatal warnings (extension field).
object
Represents a non-fatal warning from the API.
code
string
Machine-readable warning code.
Min length1
message
string
Human-readable warning message.
Min length1
Was this article helpful?
